home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / dfÜ / bbs / aptbbs1 / apt / modules / soapbox.doc < prev    next >
Encoding:
Text File  |  1995-03-09  |  7.4 KB  |  397 lines
  1.  
  2.  
  3.  
  4.                                        1
  5.  
  6.  
  7.  
  8.                       _________  _________  ______    ________
  9.                      /          /        / /      \  /        \
  10.                     /          /        / /       / /         /
  11.                    /________  /        / /_______/ /_________/
  12.                            / /        / /       / /
  13.                   ________/ /________/ /       / /      BOX
  14.            __________________________________________________________
  15.  
  16.                        Copyright (c) 1994 Andy Grifo.
  17.  
  18.  
  19.           For use only with the ApT-BBS Conferencing System package.
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                        1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                        2
  71.  
  72.  
  73.      The story of "The WALL!"
  74.  
  75.  
  76.           Walls, OneLiners..  call them what you will, they have all been
  77.      with us for a considerable amount of time and have allowed users to
  78.      leave all forms of "comments,remarks" on just about any subject they
  79.      wish.  Users logging onto the system would be presented with the so
  80.      called "wall" to which would contain around 10 or more lines of
  81.      comments. The user would then have the chance of being able to write
  82.      their own comment (one line..) followed by the program exiting..  and
  83.      that, basically, was that, and the story of "The Wall".
  84.  
  85.      "Walls" have become part of a legend in their own right and users have
  86.      always taken to them because it was known that everyone else would see
  87.      the handy work of the user, whatever it might have been.
  88.  
  89.      However, They have always been simple affairs, ..  until, that is,of
  90.      the arrival of "SoapBox".
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                        2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                        3
  137.  
  138.  
  139.      What this program is intended to do:
  140.  
  141.  
  142.           This program is intended to bring a WALL type environment to your
  143.      BBS system, with a difference. It has various features that have never
  144.      been seen in any other wall-type environment, and is, "The" definite
  145.      wall of the 90's. This is an entirely "original" product, with the
  146.      only non-original aspect being the "idea of the comments on the wall"
  147.      themselves, which gives the system 99% originality.
  148.  
  149.  
  150.      The major features of ApT-SoapBox:
  151.  
  152.      o Can be made resident which allows for faster loading, also
  153.      benefiting multiline system usege.
  154.  
  155.      o The SoapBox can contain a maximum of 57 comment lines (4 pages)
  156.      which can be viewed easily so that if a "thread" is being followed
  157.      users can easily pick up on what is going on or simply view comments
  158.      that may have spanned over a week or so.
  159.  
  160.      o Whenever the SoapBox is used it always positions itself at the very
  161.      last page so that the user sees the "latest" comments straight out.
  162.  
  163.      o Users are able to view WHO typed the comments with the handy "WHO"
  164.      feature, this is a "toggle" switch.
  165.  
  166.      o The ability for the users to SPIT on a users comment - This results
  167.      in the comment background being turned GREEN which normally denotes
  168.      content/dislike/non-agreement/hatred (you get the picture) with a
  169.      comment.
  170.  
  171.      o The ability for the users to POLISH a users comment - This results
  172.      in the comment background being turned BLUE thus denoting that the
  173.      user is showing "agreement/like/respect/etc." with the comment.
  174.  
  175.      o Users are only able to SPIT or POLISH other peoples comments and NOT
  176.      their own.
  177.  
  178.      o The Sysop is allowed to remove a comment that is deemed to be "not-
  179.      required"
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                        3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                        4
  203.  
  204.  
  205.      Are they any good?
  206.  
  207.  
  208.           Well, the answer to that is, "it depends on your system, and your
  209.      users", but you will surely find that once the users enter into the
  210.      spirt of the whole idea it becomes a very popular item.  The one
  211.      problem with the vast majority of BBS systems is that they rarely give
  212.      the users a chance to "communicate" with other users easily.  This
  213.      method allows for users to agree/disagree, shout, moan..  get other
  214.      users angry, or whatever and basically get involved with the other
  215.      users from "day one", and WALLS are basically in essence what bulletin
  216.      boards are about, letting the users "leave a message" for the others
  217.      to see and being sure that they will indeed see that comment.
  218.      Users "without a view" (the ones that simply look and never add
  219.      comments) are also getting the chance to get involved into the spirit
  220.      of the "wall" with the options of being able to "Spit" or "Polish"
  221.      other peoples comments.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                        4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                        5
  269.  
  270.  
  271.      Installing ApT-SoapBox
  272.  
  273.  
  274.  
  275.           SoapBox requires the user to be using ANSI-POSITIONING and if the
  276.      user is not doing so then the program will cleanly exit without any
  277.      explanation. This is done for a certain reason which is because that
  278.      normally the SoapBox will be placed within a "Interlogin" sequence of
  279.      a system and then called - If the user does not have the correct flags
  280.      set then the program will exit and your login sequence will continue
  281.      with no messy screens or words to denote the failure of the program.
  282.      However, it IS required to explain to the user WHY the program does
  283.      not work IF it is being used from a "menu" - What should happen here
  284.      is that a check is done to see if the user has the ANSI_POS flag set,
  285.      if not you should explain that it is required in order to use the
  286.      program.
  287.  
  288.      'gfxflag' "test 1" ; ansipos = result
  289.  
  290.      if(ansipos=1) then do
  291.           'LOCKDOOR' "apt:modules/SoapBox"
  292.      end ; else do
  293.        'msg' "%CLS.The SoapBox requires AnsiPositioning to be turned on.\n"
  294.        'msg' "Press a key to return to the menu %WAITKEY."
  295.      end
  296.  
  297.      The SoapBox can easily be installed by using the 'LOCKDOOR' or
  298.      LockDoor() command(s),
  299.  
  300.      'LOCKDOOR' "apt:modules/SoapBox"
  301.  
  302.      In normal use the program should be made resident IF it is being
  303.      called within some form of "login procedure" environment.  In order to
  304.      do this you should firstly decide on an ALIAS for the command,
  305.      generally SBOX should do the trick, and from your BBS startup script
  306.      you would have something like:
  307.  
  308.      resident SBOX apt:modules/SoapBox
  309.  
  310.      The program would then be called with:
  311.  
  312.      'LOCKDOOR' "SBOX"
  313.  
  314.      This would speed up the loading because the program resides in memory.
  315.      Also if running a multi-line system this is the choice because the
  316.      same program will service all of the possible lines.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                        5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                        6
  335.  
  336.  
  337.      Commands and uses:
  338.  
  339.  
  340.      The SoapBox logic allows it to use various forms of user input in
  341.      order to achieve a goal. Depending on how many pages of comments you
  342.      have will allow the user to page up/down by using the displayed keys
  343.      "onscreen" as well as a combination of the Numeric Keypad functions
  344.      and also the CursorKeys.
  345.  
  346.      If a comment needs to be removed (for whatever reason), then the
  347.      pressing the "R" key will allow this which can only be used by
  348.      the Sysop.
  349.  
  350.      Users that have an access level of 0 can not add any comments to the
  351.      wall.
  352.  
  353.      The other keys and options speak for themselves.
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                        6
  394.  
  395.  
  396.  
  397.